home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / bbs / ms_ad11.zip / FILE_ID.DIZ < prev    next >
Text File  |  1993-12-14  |  4KB  |  80 lines
  1.                             ADD DESCRIPT V1.1
  2.                             -----------------
  3.  
  4.                    Written by Ray Akey (AKA Heavy Metal)
  5.                          Distributed by MetalSoft
  6.                        Written for CNet Amiga v2.96+
  7.  
  8. Changes v1.1
  9. -------------
  10.    *  FILE_ID.DIZ support added - READ ENTIRE VERSION 1.1 CHANGES info!!
  11.  
  12.    1. AddDescript has been made fully MULTI-PORT compatible and relies on
  13.       environment variables to control it's port activity.  "ENV:" must be
  14.       assigned, as should "T:" if you do not specify a WORKDIR in
  15.       SYSDATA:ADDDESCRIPT.CFG.
  16.  
  17.    2. Added FILE-ID.DIZ support.
  18.       Using the <DIZ> keyword overrides LONG, SHORT and EXT keywords.
  19.       AddDescript will decide whether to add to the SHORT or LONG
  20.       (response 0) description based on your "SHORTLEN" setting in the
  21.       configuration file.  Any file_id.diz file containing more than SHORTLEN
  22.       characters will be treated as a LONG description, otherwise, it will be
  23.       added as a SHORT description.
  24.       Packer types and their associated decompression commands are located
  25.       in sysdata:AddDescript.cfg, as is the temporary WORKDIR setting.  If
  26.       a "WORKDIR" is specified, AddDescript will use that directory as it's
  27.       processing directory for decompression, etc,..
  28.       If using the <DIZ> keyword, you MUST have "sysdata:AddDescript.cfg"
  29.       configured to your system specifics as noted in that file. A typical
  30.       command string in your xscript (ie. xlha2lha - sample enclosed in this
  31.       package) would be:
  32.  
  33.               ;Add FILE-ID.DIZ as descript if existent.
  34.               runback pfiles:adddescript DIZ UDBase0: {PATHF}
  35.  
  36.       NOTE: To use in scripts converting to different compression types
  37.             (ie. xzip2lha), the {PATHF} in the above example should be
  38.             replaced with {NEWN} .
  39.   
  40.       ALSO: for some reason CNet won't let AddDescript alter the SHORT
  41.             response unless AddDescript is RUNBACK'd.  I'm sure there will be
  42.             a fix for this once I find out if CNet is indeed keeping a "LOCK"
  43.             on the short descriptions, which I hope Ken Pletzer will remove.
  44.             As long as RUNBACK is used for AddDescript when working with DIZ
  45.             files, the process is flawless.  This doesn't seem to be a problem
  46.             unless the <DIZ> option is enabled.  Also note that since
  47.             runback is used, your TRANSFORM will NOT be completed when CNet
  48.             says it is.  You must give AddDescript time to process
  49.             FILE_ID.DIZ and add it to the short description.  Go on about
  50.             your business, the process is flawless provided the same file is
  51.             not transformed twice at the SAME TIME (which is impossible if
  52.             CNet's "already transformed" protection is in working order).
  53.  
  54.  
  55. What is it?
  56. -----------
  57.    AddDescript is a program that will add a text file to the long description
  58. of a file being adopted, transformed or uploaded.
  59.  
  60.    It was mainly created at the request of Gregory Hopkins for the purpose
  61. of using it in a .TIC-type transformation script.
  62.  
  63.    It can be used at any time.  See the NOTE below though.
  64.  
  65.    NOTE: If ANY responses exist to the item the text is being added to, the
  66.          LAST existing response will be replaced with the text in the "DESC"
  67.          file.  For this reason, AddDescript should be used IMMEDIATELY after
  68.          a file has been uploaded or adopted.
  69.  
  70.  
  71.    I'm sure this will be a VERY useful utility to many CNet BBS' involved
  72. in networking.  I make no claims that it will be easy to install as it
  73. is a utility that only experienced CNet SysOps will use anyway.
  74.  
  75.    For this reason, I present it as a gift to ALL CNET SYSOPS
  76. as FREEWARE.  Please let me know if you use this utility so I may continue
  77. development.
  78.  
  79. Ray Akey - MetalSoft
  80.